home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / mgr / sparcmgr / demo1.zoo / demo / msg / README < prev    next >
Encoding:
Text File  |  1989-01-24  |  2.3 KB  |  66 lines
  1. #                        Copyright (c) 1987 Bellcore
  2. #                            All Rights Reserved
  3. #       Permission is granted to copy or use this program, EXCEPT that it
  4. #       may not be sold for profit, the copyright notice must be reproduced
  5. #       on copies, and credit should be given to Bellcore where it is due.
  6. #       BELLCORE MAKES NO WARRANTY AND ACCEPTS NO LIABILITY FOR THIS PROGRAM.
  7.  
  8. #    $Header: README,v 1.2 88/08/29 13:23:05 sau Exp $
  9. #    $Source: /tmp/mgrsrc/demo/msg/RCS/README,v $
  10.  
  11. This directory contains a sample client-server system.  It uses menus
  12. to traverse the file system, and servers to do things to selected files.
  13.  
  14. * do        runs a unix command as a server
  15. * start        calls do with a bunch of canned servers
  16. * client        monitors communications, and is a prototype for clients
  17. * alias        is a CSH alias that lets the shell send messages to the servers
  18.                 via mgr menus
  19. * send        sends a message to a server
  20. * menus        downloads menus into mgr for use with send and do
  21.  
  22. USAGE
  23. -----
  24.  
  25. 1) type make (makes do,client,menus,send and alias)
  26.    - make sure LIB and INCL in Makefile are correct
  27. 2) make sure you are running mgr (and it is suid to root)
  28. 3) switch to csh (or convert alias to your favorite shell equivalent)
  29. 4) source alias
  30. 5) start up some clients (using start) - try "start more"
  31.    - open a new window and change to this directory
  32.    - cat start for some examples
  33.    - make sure the appropriate icons are in .../icon
  34.    
  35. 6) type "cd ." to start things off.
  36. 7) use the menu (button 2) to select a file, then
  37.    use button 1 to pick a server
  38.  
  39.  
  40.  
  41. MGR message subsystem summary
  42. --- ------- --------- -------
  43. m_put(str)        put STR into the global buffer
  44. m_snarf()        return the global buffer
  45.  
  46. m_broadcast(str)    broadcast STR to all listeners
  47. m_sendme(str)        send STR back to self
  48. m_sendto(id,str)    send STR to window ID
  49.  
  50. Message events:
  51.     ACCEPT        accept messages from applications
  52.             running in other windows.
  53.  
  54.     NOTIFY        register a name with MGR, and make this 
  55.             name available to other applications 
  56.  
  57. event parameters (for button events):
  58.     %n        notify message (if any) from clicked-on window.
  59.     %w        same as %n, only the ID of the window
  60.     %S        The length of the string returned by %n.
  61.  
  62. accept parameters:
  63.     %f        id of message sender, as used in m_sendto()
  64.     %m        text of message sent by m_sendto().
  65.     %s        length (in chars) of the %m string
  66.